============== Toolkit Basics ============== -------- Projects -------- After :ref:`creating an account and logging in `, you can now access **projects**. To view a previously created project, you must be added to the project by a superuser. (See :ref:`User Access and Index Management`). .. figure:: /_static/projects.png *An example of projects view* If you don’t see something like the screenshot above, click on **Projects** in the upper left corner. .. image:: /_static/projects-icon.png *The projects view button* The blue ribbon in the top is the main menu and is used to access all other parts of the toolkit. The numbers after the menu items **Lexicons**, **Models** and **Tools** shows the number of resources already present in an active Project. The **Projects** view gives you an overview of different projects in the corpus. **In this view you can:** * create a new project (see more at :ref:`Creating a New Project`) * view project IDs * view project titles * view project authors * view indices in a project * view resources in a project * view users in a project * select the project you’re currently working on * see if the application has any problems (more about this in :ref:`Health`) |br| ------ Finding a Project ================= You can filter the projects in this view by author name or by title in the grayed out search boxes next to **Create**. .. image:: /_static/filterprojects.png You can also sort the projects by pressing on the words **id**, **Title**, **Author**, **Indices**, **Resources** or **Users** and sort them either in ascending or descending order for numerical values or in alphabetical (or reverse alphabetical order) for word values. .. image:: /_static/proj-sort-asc.png :scale: 60% .. image:: /_static/proj-sort-desc.png :scale: 60% *Sorting by ascending and descending ID values.* |br| ------ Using a Project =============== To pick the project you’re working on, choose your project in the **Projects** view, then click on the three dots under **Actions** and pick **Use**. .. image:: /_static/use-project.png :scale: 80% Another way is by picking the project from the Projects drop-down list in the upper right corner of the screen. .. image:: /_static/use-project2.png :scale: 80% |br| ------ View indices, resources or users in a project ============================================= You can click on the number of indices, resources or users in a project to get more information. You can view the usernames associated with a project, see index names used in the project or view the number and type of resources used in the project. This only works if there are any indices, resources or users to display, otherwise the number will be a gray zero (*0*). .. image:: /_static/view-users.png :scale: 80% *Viewing users* |br| ------ ----------- Search view ----------- After selecting a project, you can now search for documents in that project. The **Search** view allows you to search for documents in an index (read more about :ref:`Indices`). Access the Search View ====================== You can access the Search view by clicking on **Search** in the upper left corner. .. image:: /_static/projects-search.png **In this view you can:** * view documents in an index * change the number of documents displayed * change how much and what information is displayed * save found documents (see more in :ref:`Downloading Data`) * view saved search queries, create aggregations of search intersections and use more searching tools (more information in :ref:`Searching`) |br| ------ Search view options =================== .. image:: /_static/search-view.png :scale: 60% The screenshot above shows the Search view with no index selected. On the left is the **Searcher**, which allows you to see searches, saved queries and as aggregations. While viewing an index, you can toggle which columns you’d like to see by clicking on **Toggle columns**. For example, when looking at a large amount of documents, perhaps you only want to view the page number and text, while not including all the metadata that might be shown automatically. To do this, you pick which columns you’d like to view from the drop-down menu depicted below. You can also pick to **Select all**. Click anywhere else to reload the data. .. image:: /_static/toggle-columns.png :scale: 80% *An example of toggling columns to select what fields to view* .. note:: You can also hide the Searcher by clicking on the **Toggle drawer** button for a better view at the data. |br| ------ Change documents per page ========================= .. image:: /_static/items-per-page.png You can choose how many documents to show at once by clicking on **Items per page** on the right, under your username and the projects and indices drop-down menu. A drop-down menu will appear, where you can choose from 1, 10, 20 or 50 documents. |br| ------ Navigating through documents ============================ You can navigate to a different page using the buttons in the upper right corner under the menu bar. The **<** and **>** buttons move to the previous and next batch of documents, while **<<** and **>>** go straight to the beginning (starting at document 0) and end of the documents (up to 10 000). .. image:: /_static/navigation1.png Information about documents currently being viewed is to the left of the buttons: * *1-10* in the screenshot above shows the amount of documents shown and their numbers (1-10, so 10 documents). Going forward one page would show documents *11-20*. * The numbers in parentheses *(18538/18538)* show the amount of documents found using the current search parameters and total amount of documents. So, for example if we make a query in the same index that is associated with **220** documents, the result will look like this, indicating that search is displaying 220 documents of 18 538: .. image:: /_static/navigation2.png |br| ------ Sorting data based on fields ============================ You can sort the data based on the values in a field (column) similarly to sorting the projects (see :ref:`Finding a Project`). Click on the fields you wish to sort by to sort the items in ascending order (↑ should appear next to the field). Or click twice for descending order (↓ should appear next to the field). For text fields, this means sorting alphabetically or in reverse alphabetical order. .. image:: /_static/unsorted-file.png :scale: 40% *Unsorted documents.* .. image:: /_static/sorted-file-asc.png :scale: 40% *Sorting by ascending filenames.* .. image:: /_static/sorted-file-desc.png :scale: 40% *Sorting by descending filenames.* |br| ------ ------- Indices ------- **Indices** are a collection of documents. Documents in indices are viewable in the Search view, where one row indicates a document and columns indicate different fields. Picking an index to look at in Search view ========================================== 1. First, pick a Project (see more information in :ref:`Projects`) and navigate to the **Search** view (more about this in :ref:`Access the Search View`). .. image:: /_static/indices-select.png :scale: 60% 2. Then, in the upper rightmost corner you can click on the field **Indices** to access a drop-down menu. .. image:: /_static/indices-select1.png :scale: 60% 3. You can either **Select all** or pick which indices you wish to see at once in the Search view. .. note:: For larger indices, especially ones with longer documents, we recommend viewing only one index at a time. .. image:: /_static/searcher.png 4. Click away to close the drop-down menu, then press **Search** in the Searcher window to see the results. .. image:: /_static/indices-select2.png :scale: 40% The result - data is displayed. |br| ------ ----- Facts ----- **Facts** or **texta_facts** are metadata that is added to or extracted from documents. Applying metadata as facts makes it easier to search for and aggregate documents. See :ref:`Data Extraction and Classification` to add your own metadata as facts. Applied facts can be edited or deleted either individually or using mass edit/delete tools, see :ref:`Editing and Deleting Facts (Facts Manager)` for more information. .. image:: /_static/facts-thesis.png :scale: 80% *An example of a thesis with metadata. Genre is MA Thesis, University is University of Tartu and Publication year is 2016.* .. image:: /_static/facts-journal.png :scale: 80% *An example of a journal article with metadata. Genre is Journal Articles, Publication (name) is Mäetagused and Publication year is 1997.* You can hide irrelevant facts by clicking on the eye icon (|eye-black|) next to **texta_facts** shown in the screenshot above. .. |eye-black| image:: /_static/eye-black.png .. image:: /_static/edit-fact-vis.png :scale: 80% After clicking the eye icon, the **Edit fact name visibility** menu will appear. Click on the **Fact name** field to access the drop-down menu. .. image:: /_static/edit-fact-vis2.png :scale: 80% *Deselecting Genre from visibility.* .. image:: /_static/edit-fact-vis3.png Pick the fact names you want to see, then click on **Apply**. .. image:: /_static/edit-fact-vis4.png *The result of hiding the Genre fact from the example journal article.* |br| ------ ---------------- Tools and Models ---------------- .. image:: /_static/tools-models.png *Tools and Models in the menu.* To use any of the tools (in the **Tools** menu) or models (in the **Models** menu) in the Toolkit, you must create a task. For example, if you click on **Dataset Importer** in the **Tools** menu, you will see a mostly empty screen. .. image:: /_static/create-task.png *Example from Dataset Importer.* On the left are buttons for creating a new task (**Create**), a wastebasket logo for deleting tasks and search fields for filtering tasks by description or status. .. image:: /_static/task-items.png And on the right you have the option of changing items (tasks) shown per page and navigating through pages. If you have already created a task, it will be shown under the menu, as described above. .. image:: /_static/example-task.png :scale: 40% *An example task.* Most of the tasks will include description, author name, dataset and time started/completed with a taskbar for showing the progress. You can click on any of the tasks for an overview of the parameters used to create it. Most tasks also have an Actions menu with three dots. .. image:: /_static/actions1.png *The actions menu.* .. image:: /_static/actions2.png *The actions menu after clicking on the options.* In the case of the Dataset Importer the only action is to **Delete** the task, but some tasks also have actions like **Clone** or **Edit**. Besides the Create and Delete buttons, there might be other options, for example **Apply to text**. .. |br| raw:: html